Send(Byte[],Int32,Int32,SocketFlags) Method

Send data to the server, specifying a buffer, offset, count and SocketFlags value.

[Visual Basic]
<DescriptionAttribute("Send data from your buffer.")>
Overloads Public Function Send( _
   ByVal buffer() As Byte, _
   ByVal offset As Integer, _
   ByVal count As Integer, _
   ByVal socketFlags As SocketFlags _
) As Segment

[C#]
[DescriptionAttribute("Send data from your buffer.")]
public Segment Send( 
   byte[] buffer,
   int offset,
   int count,
   SocketFlags socketFlags
);

[C++]
[DescriptionAttribute("Send data from your buffer.")]
public: Segment* Send( 
   byte[]* buffer,
   int offset,
   int count,
   SocketFlags socketFlags
)

[C++/CLI]
[DescriptionAttribute("Send data from your buffer.")]
public:
Segment^ Send( 
   bytearray<buffer>^ buffer,
   int offset,
   int count,
   SocketFlags socketFlags
)

Parameters

buffer: Source memory location for the data to send.
offset: Starting offset within buffer for sending.
count: Number of bytes to send.
socketFlags: A bitwise combination of special use sending parameters.

Return Type

A Segment object encapsulating information about the data sent.

Exceptions

Exception	Description
ArgumentOutOfRangeException	offset or count is less than 0.
ArgumentException	offset + count is greater than the length of buffer.
SocketException	The socket is not connected.

Remarks

After connecting, data can be received using the Send method. All Send methods return a Segment object, encapsulating information about the data sent such as the data sent, and the amount of bytes of data sent.

This method is the only way to send data to a host while specifying a SocketFlags parameter.

Example

The following example demonstrates sending bytes to the server with a SocketFlag option.

[Visual Basic]

Private Sub Test()

   ' Connect to an echo port

   Tcp1.Connect("atropos", 7)



   Dim sendbuffer() As Byte = System.Text.Encoding.Default.GetBytes("abcdefg")



   ' Send some bytes with "OutOfBand" SocketFlag option

   Tcp1.Send(sendbuffer, 0, sendbuffer.Length, SocketFlags.OutOfBand)



   Dim recvbuffer(sendbuffer.Length) As Byte



   ' Server will echo the bytes back. Receive the bytes.

   Tcp1.Receive(recvbuffer, 0, recvbuffer.Length, SocketFlags.None)



   ' Close the connection.

   Tcp1.Close()

End Sub

[C#]



private void Test()

{

  // Connect to the echo port

  tcp1.Connect("atropos", 7);



  byte[] sendbuffer = System.Text.Encoding.Default.GetBytes("abcdefg");



  // Send some bytes with "OutOfBand" SocketFlag option

  tcp1.Send(sendbuffer, 0, sendbuffer.Length, SocketFlags.OutOfBand);



  byte[] recvbuffer = new byte[sendbuffer.Length];



  // Server will echo the bytes back. Receive the bytes.

  tcp1.Receive(recvbuffer, 0, recvbuffer.Length, SocketFlags.None);



  // Close the connection.

  tcp1.Close();

}

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Requirements

Language

Send(Byte[],Int32,Int32,SocketFlags) Method

Parameters

Return Type

Exceptions

Remarks

Example

Requirements

See Also